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Specifying a Namespace Extension's Location 

The root of a namespace extension is normally displayed by Microsoft Windows Explorer as a folder in both tree 
and folder views. For Windows Explorer to display your extension's files and subfolders, you must specify where 
the root folder is located in the Shell namespace hierarchy. This location is referred to as a junction point. 

• Using Virtual Folders as Junction Points 

• Using File System Folders as Junction Points 

• Opening a View of a Namespace Extension 

Using Virtual Folders as Junction Points 

The simplest way to define an extension's junction point is to make the root folder a subfolder of a system virtual 
folder. This type of junction point is referred to as a virtual junction point. The Desktop and My Computer 
folders are the typical locations for virtual junction points, but you can also define a virtual junction point on a 
remote computer or under the My Network Places, Internet Explorer, and Control Panel folders. 

To define a virtual junction point, create a subkey of the key that represents the appropriate virtual folder and 
name it with the string form of your extension's class identifier (CLSID). The registered CLSID would appear as 
follows. 



HKEY_LOCAL_MACHIIME 
Software 

Microsoft 

Windows 

CurrentVersion 
Explorer 

Virtual Folder Name 
Namespace 

{Extension CLSID} 

Virtual Folder Name is one of the registry key names in the following table. 

Location Virtual Folder Name 

My Computer MyComputer 

Desktop Desktop 

Control Panel ControlPanel 

My Network Places NetworkNeighborhood 

Entire Network NetworkNeighborhood\EntireNetwork 

Remote Computer RemoteComputer 

Remote extensions must be initialized with IRemoteComputer . 

Note You can also define junction points on a per-user basis by registering them in the equivalent location under 
the HKEY_CURRENT_USER key. 

Using File System Folders as Junction Points 

There are two ways to define file system folders as junction points. The simplest approach is to create a folder in 
the appropriate location and append a period to the folder's name, followed by the string form of the CLSID of 
your extension. Only the folder name will be visible in Windows Explorer. The following example creates a 
junction point with a display name of MyFolder. 

MyFolder . {Extension CLSID} 
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Alternatively, you can define a conventionally named folder as a junction point by: 

• Making the folder read-only. 

• Making the folder a system folder by calling PathMakeSystemFolder . 

• Placing a hidden Desktop.ini file in the folder that includes the extension's CLSID. 

Desktop.ini is a standard text file that can be added to any folder to customize certain aspects of the folder's 
behavior. For a general discussion of how to use this file, see Customizing Folders with Desktop.ini . To define a 
folder as a junction point, the [.ShellClassInfo] section of Desktop.ini must contain the extension's CLSID as 
follows: 

[ .ShellClassInfo] 
CLSID={Extension CLSID} 

Opening a View of a Namespace Extension 

When a user browses into a junction point, Windows Explorer automatically creates a view of the root folder. You 
can also create a view by explicitly launching Explorer.exe with the extension's CLSID as an argument. You can, 
for instance, use this approach to launch a view of an extension from a shortcut menu or shortcut. For example, 
to launch a view of MyExtension that includes a tree view, you can use the following command string. 

%SystemRoot%\Explorer . exe /e, :: {MyExtension CLSID} 

An alternative command string can be used to launch a view of an object within the extension. This feature would 
be useful, for instance, for an extension that uses a folder view to allow users to view the contents of one of a 
number of compressed files. 

%SystemRoot%\Explorer . exe /e, :: {MyExtension CLSID }, obj ectname 

The objectname parameter is the name of the object that is to be viewed. Windows Explorer converts the name 
to its corresponding PIDL and passes the PIDL to the new folder object's Initialize method. 

Note The CLSID string must be preceded by a pair of colons (::) or the command will fail. The slash-e (/e) flag 
used in the two sample command lines shown previously instructs Windows Explorer to display a tree view. The 
flag must be separated from the two colons by a comma. If you do not want a tree view, omit the /e flag and the 
comma. 
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Specifying a Namespace Extension's Location 

The root of a namespace extension is normally displayed by Microsoft Windows Explorer as a folder in both tree 
and folder views. For Windows Explorer to display your extension's files and subfolders, you must specify where 
the root folder is located in the Shell namespace hierarchy. This location is referred to as a junction point. 

o Using Virtual Folders as Junction Points 

o Using File System Folders as Junction Points 

o Opening a View of a Namespace Extension 

Using Virtual Folders as Junction Points 

The simplest way to define an extension's junction point is to make the root folder a subfolder of a system virtual 
folder. This type of junction point is referred to as a virtual junction point. The Desktop and My Computer 
folders are the typical locations for virtual junction points, but you can also define a virtual junction point on a 
remote computer or under the My Network Places, Internet Explorer, and Control Panel folders. 

To define a virtual junction point, create a subkey of the key that represents the appropriate virtual folder and 
name it with the string form of your extension's class identifier (CLSID). The registered CLSID would appear as 
follows. 



HKEY_LOCAL_MACHINE 
Software 

Microsoft 

Windows 

CurrentVersion 
Explorer 

Virtual Folder Name 
Namespace 

{Extension CLSID} 

Virtual Folder Name is one of the registry key names in the following table. 

Location Virtual Folder Name 

My Computer MyComputer 

Desktop Desktop 

Control Panel ControlPanel 

My Network Places NetworkNeighborhood 

Entire Network NetworkNeighborhood\EntireNetwork 

Remote Computer RemoteComputer 

Remote extensions must be initialized with IRemoteComputer . 

Note You can also define junction points on a per-user basis by registering them in the equivalent location under 
the HKEY_CURRENT_USER key. 

Using File System Folders as Junction Points 

There are two ways to define file system folders as junction points. The simplest approach is to create a folder in 
the appropriate location and append a period to the folder's name, followed by the string form of the CLSID of 
your extension. Only the folder name will be visible in Windows Explorer. The following example creates a 
junction point with a display name of MyFolder. 



MyFolder . {Extension CLSID} 
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Alternatively, you can define a conventionally named folder as a junction point by: 
o Making the folder read-only. 

o Making the folder a system folder by calling PathMakeSystemFolder . 

o Placing a hidden Desktop.ini file in the folder that includes the extension's CLSID. 

Desktop.ini is a standard text file that can be added to any folder to customize certain aspects of the folder's 
behavior. For a general discussion of how to use this file, see Customizing Folders with Desktop.ini . To define a 
folder as a junction point, the [.ShellClassInfo] section of Desktop.ini must contain the extension's CLSID as 
follows: 

[ .ShellClassInfo] 
CLSID={Extension CLSID} 

Opening a View of a Namespace Extension 

When a user browses into a junction point, Windows Explorer automatically creates a view of the root folder. You 
can also create a view by explicitly launching Explorer.exe with the extension's CLSID as an argument. You can, 
for instance, use this approach to launch a view of an extension from a shortcut menu or shortcut. For example, 
to launch a view of MyExtension that includes a tree view, you can use the following command string. 

%SystemRoot%\Explorer . exe /e, :: {MyExtension CLSID} 

An alternative command string can be used to launch a view of an object within the extension. This feature would 
be useful, for instance, for an extension that uses a folder view to allow users to view the contents of one of a 
number of compressed files. 

%SystemRoot%\Explorer .exe /e, :: {MyExtension CLSID }, obj ectname 

The objectname parameter is the name of the object that is to be viewed. Windows Explorer converts the name 
to its corresponding PIDL and passes the PIDL to the new folder object's Initialize method. 

Note The CLSID string must be preceded by a pair of colons (::) or the command will fail. The slash-e (/e) flag 
used in the two sample command lines shown previously instructs Windows Explorer to display a tree view. The 
flag must be separated from the two colons by a comma. If you do not want a tree view, omit the /e flag and the 
comma. 
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